reservations-eapi

Whilst every effort will be made to capture all errors which may be returned for these API resources on this page, consumers are advised that as RDG are using a common service (frequently known as Software as a Service or SaaS) for the underlying technology within the reservation service, additional error cases may be added to the product at any time. If you are returned an error not recorded here, please provide details to RDG, including the request which generated the error and the error message itself, and we will investigate and add to this page.

If a request passes the policy checks it will be submitted to the relevant RDG API which may then result in an RDG specific error as opposed to a generic platform error. APIs on the RDG Developer Portal use the following common error format to contain and return these errors to consumers (See RDG Error Object data type):

{
    "errors": [
        {
            "code": "error_code",
            "message": "error message",
            "timestamp": "YYYY-MM-DDTHH:MM:SS",
            "context": {
                "{key}": "value"
            }
        }
    ]
}

The (optional) context object is an unspecified list of key value pairs, allowing contextual information to be provided without requiring a schema definition.

Reservations specific error handling

For the reservations service, the below list represents the known context keys which may be returned by the source service. This list is not within RDG control and is subject to change at any time. Please report any context keys which are not in the list below to cci-support@raildeliverygroup.com and RDG will review and update this page to include them.

Field name keys:
- location
- disabilityType
- rsid
- departureDate
- serviceOriginDate
- ticketTypeCode
- routeCode
- statusCode

There may also be context items which are not field names, such as:
- expected
- got
- reason
- description

Known Error Cases

General

Availability

Last update: 05-Aug-2024 14.00: ASSIST API Documentation Maintenance: 'reservations-eapi', Version 'v2', Page 'Error handling', Revision 'B'.

To request updates to this text please contact Neil Barkham.